home *** CD-ROM | disk | FTP | other *** search
/ Software of the Month Club 2000 October / Software of the Month - Ultimate Collection Shareware 277.iso / pc / PROGRAMS / UTILITY / WINLINUX / DATA1.CAB / programs_-_include / LINUX / MCA.H < prev    next >
C/C++ Source or Header  |  1999-09-17  |  4KB  |  101 lines
  1. /*
  2.  * Header for Microchannel Architecture Bus 
  3.  * Written by Martin Kolinek, February 1996
  4. */
  5.  
  6. #ifndef _LINUX_MCA_H
  7. #define _LINUX_MCA_H
  8.  
  9. /* The detection of MCA bus is done in the real mode (using BIOS).
  10.  * The information is exported to the protected code, where this 
  11.  * variable is set to one in case MCA bus was detected.
  12. */
  13. extern int  MCA_bus;
  14.  
  15. /* maximal number of MCA slots - actually, some machines have less, but
  16. they all have sufficient number of POS registers to cover 8. */
  17. #define MCA_MAX_SLOT_NR  8
  18.  
  19. /* MCA_NOTFOUND is an error condition.  The other two indicate
  20.     motherboard POS registers contain the adapter.  They might be
  21.     returned by the mca_find_adapter() function, and can be used as
  22.     arguments to mca_read_stored_pos().  I'm not going to allow direct
  23.     access to the motherboard registers until we run across an adapter
  24.     that requires it.  We don't know enough about them to know if it's
  25.     safe.
  26.  
  27.     See Documentation/mca.txt or one of the existing drivers for
  28.     more information.
  29. */
  30. #define MCA_NOTFOUND    (-1)
  31. #define MCA_INTEGSCSI    (MCA_MAX_SLOT_NR)
  32. #define MCA_INTEGVIDEO    (MCA_MAX_SLOT_NR+1)
  33.  
  34. /* max number of adapters, including both slots and various integrated
  35. things. */
  36. #define MCA_NUMADAPTERS (MCA_MAX_SLOT_NR+2)
  37.  
  38. /* returns the slot of the first enabled adapter matching id.  User can
  39. specify a starting slot beyond zero, to deal with detecting multiple
  40. devices.  Returns MCA_NOTFOUND if id not found.  Also checks the
  41. integrated adapters. */
  42. extern int mca_find_adapter(int id, int start);
  43. extern int mca_find_unused_adapter(int id, int start);
  44.  
  45. /* adapter state info - returns 0 if no */
  46. extern int mca_isadapter(int slot);
  47. extern int mca_isenabled(int slot);
  48.  
  49. extern int mca_is_adapter_used(int slot);
  50. extern int mca_mark_as_used(int slot);
  51. extern void mca_mark_as_unused(int slot);
  52.  
  53. /* gets a byte out of POS register (stored in memory) */
  54. extern unsigned char mca_read_stored_pos(int slot, int reg);
  55.  
  56. /*
  57.     This can be expanded later.  Right now, it gives us a way of
  58.     getting meaningful information into the MCA_info structure,
  59.     so we can have a more interesting /proc/mca.
  60. */
  61. extern void mca_set_adapter_name(int slot, char* name);
  62. extern char* mca_get_adapter_name(int slot);
  63.  
  64. /*
  65.     This sets up an information callback for /proc/mca/slot?.  The
  66.     function is called with the buffer, slot, and device pointer (or
  67.     some equally informative context information, or nothing, if you
  68.     prefer), and is expected to put useful information into the
  69.     buffer.  The adapter name, id, and POS registers get printed
  70.     before this is called though, so don't do it again.
  71.  
  72.     This should be called with a NULL procfn when a module
  73.     unregisters, thus preventing kernel crashes and other such
  74.     nastiness.
  75. */
  76. typedef int (*MCA_ProcFn)(char* buf, int slot, void* dev);
  77. extern void mca_set_adapter_procfn(int slot, MCA_ProcFn, void* dev);
  78.  
  79. /* These routines actually mess with the hardware POS registers.  They
  80. temporarily disable the device (and interrupts), so make sure you know
  81. what you're doing if you use them.  Furthermore, writing to a POS may
  82. result in two devices trying to share a resource, which in turn can
  83. result in multiple devices sharing memory spaces, IRQs, or even trashing
  84. hardware.  YOU HAVE BEEN WARNED.
  85.  
  86. You can only access slots with this.  Motherboard registers are off
  87. limits.
  88. */
  89.  
  90. /* read a byte from the specified POS register. */
  91. extern unsigned char mca_read_pos(int slot, int reg);
  92.  
  93. /* write a byte to the specified POS register. */
  94. extern void mca_write_pos(int slot, int reg, unsigned char byte);
  95.  
  96. /* Should only be called by the NMI interrupt handler, this will do some
  97. fancy stuff to figure out what might have generated a NMI. */
  98. extern void mca_handle_nmi(void);
  99.  
  100. #endif /* _LINUX_MCA_H */
  101.